home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xvc / XSGIvc.z / XSGIvc
Text File  |  1998-10-30  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSGGGGIIIIvvvvcccc((((3333))))                                               XXXXSSSSGGGGIIIIvvvvcccc((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSGIvc - Control video operation
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           The XSGIvc extension permits user control of video operation
  14.           on Silicon GraphicsTM base graphics hardware.
  15.  
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           This X extension provides a range of services to permit
  19.           programmatic user control of video operations on the base
  20.           graphics hardware.  This extension does not provide a means
  21.           to control optional video hardware such as
  22.           SiriusVideo(Reg.); optional video is controlled via
  23.           VideoLibrary(3).
  24.  
  25.           Examples of control include loading video formats, setting
  26.           video output gain, setting pedestal, and changing H-phase.
  27.  
  28.  
  29.         CCCChhhhaaaannnnnnnneeeellll
  30.           The optional notion of channel adds a tangential dimension
  31.           to the existing X hierarchy of display and Screen.  Put
  32.           briefly, a single Screen's managed area may be subdivided
  33.           into channels, each a physical output which displays some or
  34.           all of the Screen.  Typically, a channel's output is to a
  35.           physical connection on the server.
  36.  
  37.           Some graphics hardware has only one channel; other kinds of
  38.           graphics hardware implement many channels.
  39.  
  40.           Neither the OpenGL(Reg.) nor standard X drawing contain the
  41.           notion of channel, and images are simply rendered to a
  42.           single managed area, or _S_c_r_e_e_n.  The portions of the managed
  43.           area produced on the physical outputs are specified by the
  44.           video format or video format combination (see description of
  45.           Combination below).
  46.  
  47.           Most XSGIvc functions require you specify a channel number
  48.           which specifies on which physical channel the operation
  49.           should be performed.  The channel number can be specified
  50.           directly; client applications may determine the number of
  51.           channels on a server via the XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyVVVViiiiddddeeeeooooSSSSccccrrrreeeeeeeennnnIIIInnnnffffoooo
  52.           function.  Channel numbers range _0 to (_n_u_m_C_h_a_n_n_e_l_s - _1).
  53.  
  54.           For most functions, you must also specify the screen on
  55.           which the channel is located.  The macros SSSSccccrrrreeeeeeeennnnCCCCoooouuuunnnntttt and
  56.           DDDDeeeeffffaaaauuuullllttttSSSSccccrrrreeeeeeeennnn may be of some value in determining the screen
  57.           number.
  58.  
  59.           A server may offer channels with varying capabilities and
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSGGGGIIIIvvvvcccc((((3333))))                                               XXXXSSSSGGGGIIIIvvvvcccc((((3333))))
  71.  
  72.  
  73.  
  74.           attributes, so it will not do to presume a uniform
  75.           arrangment if only one channel is queried.  For each
  76.           channel, query the capabilities before performing
  77.           operations.
  78.  
  79.  
  80.         CCCCoooonnnnttttrrrroooollllssss
  81.           The video output of a graphics pipe may have a number of
  82.           alterations, or _c_o_n_t_r_o_l_s, that can be made to change its
  83.           operation.  Different graphics hardware may support
  84.           different controls, and different channels on a single
  85.           graphics hardware may support different controls.  The
  86.           calling program should query the capabilities and
  87.           characteristics of a control for a channel via the function
  88.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyCCCChhhhaaaannnnnnnneeeellllIIIInnnnffffoooo.  The documentation accompanying
  89.           graphics hardware may also contain information on which
  90.           channels controls are available.
  91.  
  92.           Each control has a XXXXSSSSGGGGIIIIvvvvccccSSSSeeeetttt<_c_o_n_t_r_o_l>,,,, and a
  93.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyy<_c_o_n_t_r_o_l>,,,, function associated with it.  The Set
  94.           function allows you to change the setting or state of
  95.           operation.  The Query function returns to you the extant
  96.           settings.  The <_c_o_n_t_r_o_l> is the name of the control to be
  97.           changed or queried; for example, XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn and
  98.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyOOOOuuuuttttppppuuuuttttGGGGaaaaiiiinnnn both deal with output gain.
  99.  
  100.           The Query function returns to you information about the
  101.           capabilities or range of values permitted by the server (as
  102.           different servers may have different ranges of legal
  103.           values).  The query function returns True if the server
  104.           supports the function, False if the server does not support
  105.           it.  On servers with more than one output channel, you will
  106.           need to query the characteristics for each channel, since
  107.           different channels may have different capabilities.
  108.  
  109.  
  110.         EEEEvvvveeeennnnttttssss uuuunnnniiiiqqqquuuueeee ttttoooo XXXXSSSSGGGGIIIIvvvvcccc
  111.           XSGIvc offers a unique event type which has several sub-
  112.           types.  One large use of these events permits the client
  113.           program to monitor changes made to the different channel's
  114.           parameters by other client programs.
  115.  
  116.           Another use of events communicates asynchronous hardware
  117.           state changes (e.g., external lock status) to the client
  118.           program.
  119.  
  120.  
  121.         CCCCoooommmmbbbbiiiinnnnaaaattttiiiioooonnnn
  122.           Some servers with multiple channels permit independent
  123.           alteration of video format resolution and timing.  Other
  124.           servers may require that only a compatible ensemble of
  125.           formats, a _c_o_m_b_i_n_a_t_i_o_n, may be loaded.  The combination may
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXSSSSGGGGIIIIvvvvcccc((((3333))))                                               XXXXSSSSGGGGIIIIvvvvcccc((((3333))))
  137.  
  138.  
  139.  
  140.           either reference or include other video formats; it may
  141.           additionally include frame buffer configuration information
  142.           and default control settings for both Screen and channel.
  143.  
  144.           Combinations are prepared independently
  145.  
  146.  
  147.      FFFFIIIILLLLEEEESSSS
  148.           The system administrator may specify configuration
  149.           information to the server extension via database files.
  150.  
  151.  
  152.         mmmmoooonnnniiiinnnnffffoooo
  153.           Describes characteristics of different monitor models.
  154.  
  155.  
  156.         cccchhhhaaaannnnttttaaaabbbb
  157.           Describes which monitor is connected to which channel and
  158.           gives instructions regarding automatic monitor queries.
  159.  
  160.  
  161.  
  162.      FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  163.           The following are major functions available for use.
  164.  
  165.  
  166.         AAAAddddmmmmiiiinnnniiiissssttttrrrraaaattttiiiivvvveeee
  167.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyCCCChhhhaaaannnnnnnneeeellllIIIInnnnffffoooo - Query channel information for a
  168.           specific channel
  169.  
  170.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyVVVViiiiddddeeeeooooSSSSccccrrrreeeeeeeennnnIIIInnnnffffoooo - Query video information for the
  171.           screen
  172.  
  173.  
  174.         CCCCoooonnnnttttrrrroooollll
  175.           XXXXSSSSGGGGIIIIvvvvccccSSSSeeeetttt<_c_o_n_t_r_o_l> ---- Set the value for a particular control
  176.           on an output channel
  177.  
  178.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyy<_c_o_n_t_r_o_l> ---- Get the extant value for a particular
  179.           control on an output channel
  180.  
  181.           XXXXSSSSGGGGIIIIvvvvccccLLLLooooaaaaddddVVVViiiiddddeeeeooooFFFFoooorrrrmmmmaaaatttt - Changes the video format of a
  182.           channel
  183.  
  184.  
  185.  
  186.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  187.           X, XSGIvcSetOutputPhaseSCH, XSGIvcSetOutputGain,
  188.           XSGIvcSetOutputPhaseV, XSGIvcSetOutputPedestal,
  189.           XSGIvcSetOutputPhaseH, XSGIvcSetOutputSync,
  190.           XSGIvcStoreGammaColors8, moninfo, chantab
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.